SAM Driver for the HumanWare Brailliant BI

This is a fully functional SAM driver for use with a software driven HumanWare Brailliant BI.

This driver uses the WIN32 Comms API to talk to the Braille display so should work in Windows XP and upwards, including Windows 7 64-BIT.

Please report any bugs to Dolphin. If it crashes please tell us the crash address and registers etc, from the crash message box, also report the driver version number (check with explorer - file properties).

Features
Auto-detects Brailliant BI 32, Brailliant BI 40 and Brailliant B 80.
Supports USB and Bluetooth connections.


Using this driver

Before using this driver for the first time, you must install the USB device driver for the Brailliant BI. You can find this on the HumanWare website. Follow the instructions that come with the device driver to install it.

This driver should automatically identify the number of the virtual COM port needed to communicate with your display, but if it doesn't, follow the instructions below to find it manually:

Open System Properties by pressing WINDOWSKEY+PAUSE, 
click the "Device Manager" link, in the tree view of devices, cursor DOWN 
and RIGHT to open the Com Ports branch and you should see where the 
Humanware Brailliant BI is installed. You need this number to configure the 
display in SAM.

Finally, make sure this COM port is enabled:
From the SAM control panel, select the HumanWare Brailliant BI driver from the list.
Click the Configure button, then Serial ports.
Cursor down the list of available ports and ensure that the COM port you identified from Device Manager is enabled (checked).
Then OK the dialog.


Note: please ensure that the Brailliant BI is set to the HumanWare protocol.


Key assignments

The following lists the default keys to press for each Braille operation.
Your screen reader may not support some of these operations.

In the following list, the keys on the top of the Brailliant BI 32/40 unit are labeled from left to right: Backspace, 3, 2, 1, 4, 5, 6, Enter, with the Space bars in the middle on the front edge.
Note that the Brailliant B 80 does not have this set of keys.

For all displays, at the ends of the braille line, there are three buttons arranged vertically.  On the left is C1, C2 and C3; on the right is C4, C5 and C6.

On the front of the display are 4 buttons (32/40 models) or 8 buttons (80 model).  These are from left to right: Up, Left, Right and Down.  These keys are then repeated a second time for the 80 model.


Keys for all Brailliant BI models:

Action Open Control Panel = C1 + C3 + C5
Action Open Control Panel = C2 + C4 + C5
Action Help = C3 + C5 + C6
Speech Key Describe Mode on off = C1 + C2 + C5
Speak Keys Where am I? = C2 + C3 + C4 + C5
Speak Keys Status (Multikey) = C3 + C4
Read from Here Read from here = C1 + C2 + C3 + C4 + C5 + C6
Read from Here Stop Reading = C1 + C2 + C3 + C4 + C5 + C6
Dolphin Cursor (General) Turn Dolphin Cursor off = C4
Dolphin Cursor (General) Turn Dolphin Cursor on = C4
Dolphin Cursor (General) Interact with control = C2 + C4
Braille Document Read Back = Left
Braille Document Read Forward = Right
Braille Line up = Up
Braille Line up = C1
Braille Line down = Down
Braille Line down = C3
Braille Go To Focus = C6
Braille Line Start = Up + Left
Braille Line End = Right + Down
Braille Top = C2 + C3
Braille Bottom = C5 + C6
Braille Cell Left = C1 + C3
Braille Cell Right = C4 + C6
Braille Physical/Logical Mode = C2 + C6
Braille Literary Braille on off = C1 + C2 + C4 + C5
Braille Cycle Attributes = C1 + C6
Braille Describe Character on off = C1 + C3 + C4 + C6
Braille Tracking on off = Left + Right
Braille Eight Dot Six Dot = C2 + C3 + C5
Braille Enhance on off = C1 + C2 + C3 + C4 + C6
Braille Routing Button Action = C1 + C2 + C6
Speech Voice on off = C1 + C3 + C6
Speak Keys Line (MultiKey) = C1 + C4
Speak Keys Word (MultiKey) = C2 + C5
Speak Keys Character (MultiKey) = C3 + C6
Speak Keys Word Move to Next = C5
Speak Keys Word Move to Previous = C2
Speech Verbosity Scheme Cycle = C1 + C2 + C3 + C6
Braille Verbosity Scheme Cycle = C1 + C2
List headings = C2 + C3 + C6
List System Tray = C2 + C3 + C5 + C6


Additional keys for the Brailliant 32/40 models

Braille Physical/Logical Mode = Dot 2 + Dot 5 + Space
Braille Literary Braille on off = Dot 1 + Dot 2 + Dot 4 + Dot 5 + Space
Simulate Key Press Up = Dot 1 + Space
Simulate Key Press Down = Dot 4 + Space
Simulate Key Press Left = Dot 3 + Space
Simulate Key Press Right = Dot 6 + Space
Simulate Key Press Home = Dot 2 + Dot 3 + Space
Simulate Key Press End = Dot 5 + Dot 6 + Space
Simulate Key Press Ctrl Home = Dot 1 + Dot 2 + Dot 3 + Space
Simulate Key Press Ctrl End = Dot 4 + Dot 5 + Dot 6 + Space
Simulate Key Press Enter = Dot 8
Simulate Key Press Space = Space
Simulate Key Press Page Up = Dot 1 + Dot 2 + Space
Simulate Key Press Page Down = Dot 4 + Dot 5 + Space
Simulate Key Press Tab = Dot 4 + Dot 6 + Space
Simulate Key Press Shift Tab = Dot 1 + Dot 3 + Space
Simulate Key Press Ctrl Tab = Dot 1 + Dot 3 + Dot 4 + Dot 5 + Space
Simulate Key Press Ctrl Shift Tab = Dot 1 + Dot 2 + Dot 3 + Dot 4 + Space
Simulate Key Press Escape = Dot 1 + Dot 5 + Space
Simulate Key Press Backspace = Dot 7
Simulate Key Press Delete = Dot 1 + Dot 4 + Dot 5 + Space
Simulate Key Press Windows = Dot 3 + Dot 4 + Space
Simulate Key Press Alt = Dot 1 + Dot 3 + Dot 4 + Space
Speak Keys Sentence Move to Next = Dot 1 + Dot 3 + Dot 5 + Space
Speak Keys Sentence Move to Previous = Dot 2 + Dot 4 + Dot 6 + Space


10/2013
